Three zones ideal heating
The previous sections primarily focused on simulating the building envelope to understand how the YAML file inputs for Trano can be structured. This section will shift the focus to simulating a building equipped with a heating system. Specifically, we will consider a three-zone building featuring an ideal heating system.
Below is a description of the YAML configuration file that details the building's heating system:
emissions:
- radiator:
id: RADIATOR:001
variant: ideal
parameters:
nominal_heating_power_positive_for_heating: 2500
control:
emission_control:
id: EMISSION_CONTROL:001
parameters:
schedule: 3600*{10, 20}
temperature_heating_setpoint: 295.15
temperature_heating_setback: 291.15
In this configuration, the emissions field indicates that the space is associated with an emission system. The variant field specifies the type of radiator, which in this case is an ideal radiator. The control object of the radiator is defined within the control field, where parameters such as setpoints and schedule are outlined, along with the heating power of the ideal radiator.
Input configuration file
The described building configuration appears to be a multi-room structure featuring a combination of thermal constructions and glazing systems. Here are the key characteristics:
-
Material Use: The external walls and floors are constructed with three different materials that have low thermal conductivity and relatively high density, indicating good thermal mass properties.
-
Spatial Layout: The building contains various spaces (three distinct spaces noted) with different floor areas and heights, suggesting it may be designed for residential or small commercial use.
-
Windows and Glazing: The building includes double glazing with an air gap for insulation, which enhances thermal performance, especially in energy-efficient designs.
-
Heating System: An ideal radiator system provides heating with a scheduled control mechanism, suggesting consideration for occupant comfort and energy efficiency.
-
Room Size and Shape: The presence of both smaller (80 m²) and larger (120 m²) rooms with similar ceiling heights suggests a design that accommodates various functions or usage patterns.
Overall, the building configuration indicates an energy-efficient structure that could serve as a residence or small office, focusing on thermal comfort and efficiency.
material:
- id: MATERIAL:001
thermal_conductivity: 0.045
density: 2100.0
specific_heat_capacity: 900.0
- id: MATERIAL:002
thermal_conductivity: 0.04
density: 1950.0
specific_heat_capacity: 950.0
- id: MATERIAL:003
thermal_conductivity: 0.038
density: 2050.0
specific_heat_capacity: 920.0
constructions:
- id: CONSTRUCTION:001
layers:
- material: MATERIAL:001
thickness: 0.12
- material: MATERIAL:002
thickness: 0.08
- material: MATERIAL:003
thickness: 0.1
glass_material:
- density: 2500.0
id: GLASS:001
longwave_emissivity: 0.82
shortwave_emissivity: 0.65
specific_heat_capacity: 860.0
thermal_conductivity: 1.1
gas:
- density: 1.18
id: AIR:001
longwave_emissivity: 0.0
shortwave_emissivity: 0.0
specific_heat_capacity: 1005.0
thermal_conductivity: 0.026
glazings:
- id: INS2AR2020:001
layers:
- glass: GLASS:001
thickness: 0.005
- gas: AIR:001
thickness: 0.014
- glass: GLASS:001
thickness: 0.005
spaces:
- parameters:
floor_area: 80.0 # Smaller room
average_room_height: 2.5
id: SPACE:001
external_boundaries:
external_walls:
- surface: 90.0
azimuth: 180.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 70.0
azimuth: 90.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 160.0
azimuth: 270.0
tilt: wall
construction: CONSTRUCTION:001
floor_on_grounds:
- surface: 80.0
construction: CONSTRUCTION:001
windows:
- surface: 1.5
azimuth: 180.0
tilt: wall
construction: INS2AR2020:001
width: 1.5
height: 1.0
- parameters:
floor_area: 120.0 # Larger room with different shape
average_room_height: 2.7
id: SPACE:002
external_boundaries:
external_walls:
- surface: 120.0
azimuth: 180.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 100.0
azimuth: 90.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 220.0
azimuth: 0.0
tilt: wall
construction: CONSTRUCTION:001
floor_on_grounds:
- surface: 120.0
construction: CONSTRUCTION:001
windows:
- surface: 2.0
azimuth: 180.0
tilt: wall
construction: INS2AR2020:001
width: 2.0
height: 1.2
- parameters:
floor_area: 120.0 # Larger room with different shape
average_room_height: 2.7
id: SPACE:003
external_boundaries:
external_walls:
- surface: 120.0
azimuth: 180.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 100.0
azimuth: 90.0
tilt: wall
construction: CONSTRUCTION:001
- surface: 220.0
azimuth: 0.0
tilt: wall
construction: CONSTRUCTION:001
floor_on_grounds:
- surface: 120.0
construction: CONSTRUCTION:001
windows:
- surface: 2.0
azimuth: 180.0
tilt: wall
construction: INS2AR2020:001
width: 2.0
height: 1.2
emissions:
- radiator:
id: RADIATOR:001
variant: ideal
parameters:
nominal_heating_power_positive_for_heating: 2500
control:
emission_control:
id: EMISSION_CONTROL:001
parameters:
schedule: 3600*{10, 20}
temperature_heating_setpoint: 295.15
temperature_heating_setback: 291.15
internal_walls:
- space_1: SPACE:002
space_2: SPACE:001
construction: CONSTRUCTION:001
surface: 18.0
Code
This code snippet demonstrates how to simulate a multizone house using Trano. It leverages the same code from the previous tutorial, making it straightforward to implement.
from trano.main import simulate_model
from trano.simulate.simulate import SimulationLibraryOptions
simulate_model(
"./three_zones_ideal_heating.yaml",
SimulationLibraryOptions(
start_time=0,
end_time=2 * 3600 * 24 * 7,
tolerance=1e-4,
library_name="Buildings",
),
)
General Explanation
The code snippet imports functions required to simulate a model defined in a YAML file using specific simulation options. It sets up a simulation for a heating model across three zones.
General Description and Parameters
- Function:
simulate_model - Parameters:
-
File Path:
"./three_zones_ideal_heating.yaml"- Location of the model configuration file in YAML format.
-
SimulationLibraryOptions:
- start_time:
0 -
The initial time for the simulation (in seconds).
-
end_time:
2 * 3600 * 24 * 7 -
The final time for the simulation, calculated as 2 weeks (in seconds).
-
tolerance:
1e-4 -
The acceptable error tolerance for the simulation.
-
library_name:
"Buildings" - The name of the library used for the simulation, indicating it focuses on building systems and dynamics.
- start_time:
Outputs
The following report has been generated by Trano after simulating a three-zone building equipped with an ideal heating system.
Spaces
| hRoo | AFlo | linearizeRadiation | m_flow_nominal | mSenFac | T_start | volume |
|---|---|---|---|---|---|---|
| 2.5 | 80.0 | true | 0.01 | 1.0 | 294.15 | 200.0 |
| gain | k | occupancy | name |
|---|---|---|---|
| [40; 75; 40] | 1/7/3 | 3600*{9, 17} | occupancy_1 |
| Name | Azimuth | Construction Name | Surface | Tilt | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| externalwall_0 | 180.0 | construction_001 | 90.0 | wall | ||||||||||
| externalwall_1 | 90.0 | construction_001 | 70.0 | wall | ||||||||||
| externalwall_2 | 270.0 | construction_001 | 160.0 | wall | ||||||||||
| window_0 | 180.0 | ins2ar2020_001 | 1.5 | wall | ||||||||||
| flooronground_0 | 90.0 | construction_001 | 80.0 | floor | ||||||||||
| internal_space_002_space_001_construction | 10.0 | construction_001 | 18.0 | wall |
| hRoo | AFlo | linearizeRadiation | m_flow_nominal | mSenFac | T_start | volume |
|---|---|---|---|---|---|---|
| 2.7 | 120.0 | true | 0.01 | 1.0 | 294.15 | 324.0 |
| gain | k | occupancy | name |
|---|---|---|---|
| [40; 75; 40] | 1/7/3 | 3600*{9, 17} | occupancy_2 |
| Name | Azimuth | Construction Name | Surface | Tilt | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| externalwall_3 | 180.0 | construction_001 | 120.0 | wall | ||||||||||
| externalwall_4 | 90.0 | construction_001 | 100.0 | wall | ||||||||||
| externalwall_5 | 0.0 | construction_001 | 220.0 | wall | ||||||||||
| window_1 | 180.0 | ins2ar2020_001 | 2.0 | wall | ||||||||||
| flooronground_1 | 90.0 | construction_001 | 120.0 | floor | ||||||||||
| internal_space_002_space_001_construction | 10.0 | construction_001 | 18.0 | wall |
| hRoo | AFlo | linearizeRadiation | m_flow_nominal | mSenFac | T_start | volume |
|---|---|---|---|---|---|---|
| 2.7 | 120.0 | true | 0.01 | 1.0 | 294.15 | 324.0 |
| gain | k | occupancy | name |
|---|---|---|---|
| [40; 75; 40] | 1/7/3 | 3600*{9, 17} | occupancy_3 |
| Name | Azimuth | Construction Name | Surface | Tilt | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| externalwall_6 | 180.0 | construction_001 | 120.0 | wall | ||||||||||
| externalwall_7 | 90.0 | construction_001 | 100.0 | wall | ||||||||||
| externalwall_8 | 0.0 | construction_001 | 220.0 | wall | ||||||||||
| window_2 | 180.0 | ins2ar2020_001 | 2.0 | wall | ||||||||||
| flooronground_2 | 90.0 | construction_001 | 120.0 | floor |
| TAir_nominal | dp_nominal | n | deltaM | fraRad | Q_flow_nominal | nEle | TRad_nominal | linearized | from_dp | T_a_nominal | T_b_nominal | mDry | VWat | name |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 293.15 | 0.0 | 1.24 | 0.01 | 0.3 | 2500.0 | 1 | 293.15 | false | false | 363.15 | 353.15 | 65.75 | 0.145 | radiator_001 |
Construction
| Name | c | epsLw | epsSw | k | rho | Thickness |
|---|---|---|---|---|---|---|
| glass_001 | 860.0 | 0.82 | 0.65 | 1.1 | 2500.0 | 0.005 |
| air_001 | 1005.0 | 0.0 | 0.0 | 0.026 | 1.18 | 0.014 |
| glass_001 | 860.0 | 0.82 | 0.65 | 1.1 | 2500.0 | 0.005 |
| Name | c | epsLw | epsSw | k | rho | Thickness |
|---|---|---|---|---|---|---|
| material_001 | 900.0 | 0.85 | 0.85 | 0.045 | 2100.0 | 0.12 |
| material_002 | 950.0 | 0.85 | 0.85 | 0.04 | 1950.0 | 0.08 |
| material_003 | 920.0 | 0.85 | 0.85 | 0.038 | 2050.0 | 0.1 |